Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.buildbetter.ai/llms.txt

Use this file to discover all available pages before exploring further.

Free and open source. The CLI and skills are MIT-licensed and live at github.com/buildbetter-app/BB-Skills. You can use them with or without a paid BuildBetter account.

​
BuildBetter SH

BuildBetter SH (the bb CLI) sits next to your AI coding agent and gives it the context behind every PR — the chats, decisions, customer signals, and team conventions that produced the code. You install it once. It runs passively in the background, capturing every session you have with Claude Code, Codex, Cursor, Copilot CLI, Gemini CLI, Windsurf, or Amazon Q. Then anyone on your team can pick those sessions back up — on their machine, six months later, on a long-merged branch — with one command: 
bb agent-sessions resume

Install in one line

curl -fsSL buildbetter.sh | sh

Source on GitHub

Read the source, file issues, contribute

​
What you get

Resumable sessions

Every coding session — chat, file edits, tool calls — saved and indexed by repo, branch, PR, and commit. Resume any teammate’s session on your machine in one command.

A scriptable CLI

A small bb binary with stable exit codes and --json everywhere. Wire it into pre-commit hooks, PR templates, and CI.

Open-source skills

Slash commands like /bb-specify, /bb-review, and /trust-but-verify that show up with your team’s conventions attached.

​
The 30-second tour

# 1. Install
curl -fsSL buildbetter.sh | sh

# 2. (Optional) Sign in to sync sessions across machines and teammates
bb login

# 3. Code with your agent like normal — bb captures every session
#    in the background. No daemon, no flags, no daily startup.

# 4. Pick up where you (or anyone on your team) left off
bb agent-sessions resume
That’s the whole loop. Everything else — skills, PR linking, scripting — is built on top.

​
How sessions work

Whenever you use a supported coding agent inside a git checkout, bb:
  1. Watches the agent’s session log on disk
  2. Indexes every new turn by repo · branch · commit · author
  3. Writes a normalized record to ~/.buildbetter/sessions/
  4. Syncs to your free BuildBetter workspace if you’re signed in
When you (or a teammate) run bb agent-sessions resume, the chosen session is hydrated back into your active agent — prior conversation, file edits as a virtual diff, and any open questions the previous session left behind. You’re not reading a transcript; you’re picking the work back up. See [Agent Sessions](/pages/BuildBetter SH/agent-sessions) for storage paths, the session file schema, and worked workflows.

​
What ships in the box

A single bb binary that captures sessions, syncs them across machines, manages skills, and bridges your coding agent to BuildBetter. macOS and Linux, x86_64 and arm64. See the [CLI reference](/pages/BuildBetter SH/cli-reference).
Sessions are indexed by repo, branch, PR, and commit, then synced through your free BuildBetter account so any teammate with access to the repo can resume them. Opt-out per repo with bb config set sync.enabled false.
Nine skills that drive a spec-first workflow: /bb-specify, /bb-clarify, /bb-plan, /bb-tasks, /bb-checklist, /bb-analyze, /bb-review, /bb-implement, /bb-constitution.
Three browser-driven verification skills: /app-navigator, /trust-but-verify, /generate-tests. They walk the UI like a real user and confirm a feature actually works before you merge.
Maintenance skills like /bb-skills-update to keep installed skills fresh.

​
Supported coding agents

AgentStatus
Claude CodeSupported
Codex CLISupported
CursorSupported
GitHub Copilot CLISupported
Gemini CLISupported
WindsurfSupported
Amazon Q DeveloperSupported

​
Pricing

Free

The CLI, all skills, and a BuildBetter account with unlimited session sync. No credit card required.

BuildBetter Signal

The paid AI platform that powers customer-signal-driven specs — call/ticket/Slack ingestion, signal extraction, triage, projects. Talk to us.

​
Next steps

Install the CLI

Run the curl command and verify your install

CLI reference

Every bb command, organized by topic

Sessions deep dive

What’s captured, where it’s stored, how resume hydrates state

Skills

The slash commands that ship in each pack